home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / badaddr.z / badaddr
Encoding:
Text File  |  2002-10-03  |  4.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. bbbbaaaaddddaaaaddddddddrrrr((((DDDD3333XXXX))))                                                      bbbbaaaaddddaaaaddddddddrrrr((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr - test for valid input bus address
  10.      _bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll - test for valid input device address and return value
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_yyyy_ssss_tttt_mmmm_...._hhhh_>>>>
  15.      _iiii_nnnn_tttt _bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr_((((_vvvv_oooo_llll_aaaa_tttt_iiii_llll_eeee _vvvv_oooo_iiii_dddd _****_a_d_d_r_,,,, _iiii_nnnn_tttt _s_i_z_e_))))_;;;;
  16.      _iiii_nnnn_tttt _bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll_((((_vvvv_oooo_llll_aaaa_tttt_iiii_llll_eeee _vvvv_oooo_iiii_dddd _****_a_d_d_r_,,,, _iiii_nnnn_tttt _s_i_z_e_,,,, _vvvv_oooo_iiii_dddd _****_p_t_r_))))_;;;;
  17.  
  18.    AAAArrrrgggguuuummmmeeeennnnttttssss
  19.      _a_d_d_r The VME bus address to be probed.
  20.  
  21.      _s_i_z_e The size in bytes to probe the bus: 1, 2, 4, or 8.
  22.  
  23.      _p_t_r  A pointer to a variable of the specified _s_i_z_e (char, short, int, or
  24.           long long) into which the value read is placed.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      Typically these functions are called from a VME device driver's _iiii_nnnn_iiii_tttt(D2)
  28.      or _eeee_dddd_tttt_iiii_nnnn_iiii_tttt(D2) function to determine whether a device is present in the
  29.      system.
  30.  
  31.      Call _bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr_((((_)))) to determine whether you can read the specified physical
  32.      address.
  33.  
  34.      Call _bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll_((((_)))) when you also want to use the value read from the test
  35.      address.  This saves the time of another uncached memory access to read
  36.      the address after it has been found to be valid.
  37.  
  38. NNNNOOOOTTTTEEEESSSS
  39.      Passing an invalid _s_i_z_e will result in a system panic.
  40.  
  41.      These functions may not be called from an interrupt handler or from
  42.      routines that may be called from an interrupt handler.
  43.  
  44.      These functions are designed for systems in which device addresses have a
  45.      fixed mapping into the physical memory space.  Depending on the system
  46.      and the hardware attachment, device addresses may be mapped dynamically.
  47.      In those cases, _pppp_iiii_oooo______bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr(D3X) must be used.
  48.  
  49.      It is possible that the _bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll_((((_)))) function may changed or removed in
  50.      the future.
  51.  
  52.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  53.      When the addressed location is accessible, both functions return 0.
  54.      Otherwise, both return 1 and _bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll_((((_)))) does not modify the variable
  55.      at _p_t_r.
  56.  
  57.    SSSSeeeeeeee AAAAllllssssoooo
  58.      pio_badaddr(D3X), pio_wbadaddr(D3X), wbadaddr(D3X).
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.